home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-bridge-sr-objects-00.txt < prev    next >
Text File  |  1993-05-05  |  43KB  |  1,393 lines
  1.  
  2.  
  3.  
  4.  
  5.           Internet Draft    Source Routing Bridge MIB           May 1993
  6.  
  7.  
  8.  
  9.                         Definitions of Managed Objects for
  10.                               Source Routing Bridges
  11.  
  12.  
  13.                            Tue May  4 14:11:29 PDT 1993
  14.  
  15.  
  16.                        Draft Expiration Date: November 1993
  17.  
  18.  
  19.                                   Eric B. Decker
  20.                                cisco Systems, Inc.
  21.                                   cire@cisco.com
  22.  
  23.  
  24.                                  Keith McCloghrie
  25.                              Hughes LAN Systems, Inc.
  26.                                    kzm@hls.com
  27.  
  28.  
  29.                         Paul Langille & Anil Rijsinghani
  30.                           Digital Equipment Corporation
  31.                              anil@levers.enet.dec.com
  32.                            langille@edwin.enet.dec.com
  33.  
  34.  
  35.                                Status of this Memo
  36.  
  37.           This document is an Internet Draft.  Internet Drafts are
  38.           working documents of the Internet Engineering Task Force
  39.           (IETF), its Areas, and its Working Groups.  Note that other
  40.           groups may also distribute working documents as Internet
  41.           Drafts.
  42.  
  43.           Internet Drafts are valid for a maximum of six months and may
  44.           be updated, replaced, or obsoleted by other documents at any
  45.           time.  It is inappropriate to use Internet Drafts as reference
  46.           material or to cite them other than as a "work in progress".
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.           Decker/McCloghrie/Langille/Rijsinghani                [Page 1]
  59.  
  60.  
  61.  
  62.  
  63.           Internet Draft    Source Routing Bridge MIB           May 1993
  64.  
  65.  
  66.           1.  Introduction
  67.  
  68.           This memo defines an experimental portion of the Management
  69.           Information Base (MIB) for use with network management
  70.           protocols in TCP/IP based internets.  In particular it defines
  71.           objects for managing source routing bridges.
  72.  
  73.           The MIB was originally published in RFC 1286 section 4.1.3 as
  74.           "The dot1dSr Group." IEEE 802.5 revised its addendum to RFC
  75.           802.1(d) several times since the original MIB was published,
  76.           and in the process also changed its MIB.  For procedural
  77.           reasons, the group was split apart from the main MIB, allowing
  78.           the major portion of the Bridge MIB to advance in the
  79.           standards process largely unchanged, while the Source Routing
  80.           Group iterated at the Proposed Standard step.  Implementors
  81.           are advised to consider the two documents together.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.           Decker/McCloghrie/Langille/Rijsinghani                [Page 2]
  117.  
  118.  
  119.  
  120.  
  121.           Internet Draft    Source Routing Bridge MIB           May 1993
  122.  
  123.  
  124.           2.  The Network Management Framework
  125.  
  126.           The Internet-standard Network Management Framework consists of
  127.           three components.  They are:
  128.  
  129.           o    RFC 1155 which defines the SMI, the mechanisms used for
  130.                describing and naming objects for the purpose of
  131.                management.  RFC 1212 defines a more concise description
  132.                mechanism, which is wholly consistent with the SMI.
  133.  
  134.           o    RFC 1213 defines MIB-II, the core set of managed objects
  135.                for the Internet suite of protocols.
  136.  
  137.           o    RFC 1157 which defines the SNMP, the protocol used for
  138.                network access to managed objects.
  139.  
  140.           The Framework permits new objects to be defined for the
  141.           purpose of experimentation and evaluation.
  142.  
  143.  
  144.           2.1.  Object Definitions
  145.  
  146.           Managed objects are accessed via a virtual information store,
  147.           termed the Management Information Base or MIB.  Objects in the
  148.           MIB are defined using the subset of Abstract Syntax Notation
  149.           One (ASN.1) defined in the SMI.  In particular, each object
  150.           object type is named by an OBJECT IDENTIFIER, an
  151.           administratively assigned name.  The object type together with
  152.           an object instance serves to uniquely identify a specific
  153.           instantiation of the object.  For human convenience, we often
  154.           use a textual string, termed the descriptor, to refer to the
  155.           object type.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.           Decker/McCloghrie/Langille/Rijsinghani                [Page 3]
  175.  
  176.  
  177.  
  178.  
  179.           Internet Draft    Source Routing Bridge MIB           May 1993
  180.  
  181.  
  182.           3.  Overview
  183.  
  184.           A common device present in many networks is the Bridge.  This
  185.           device is used to connect Local Area Network segments below
  186.           the network layer.  There are two major modes defined for this
  187.           bridging; transparent and source route.  The transparent
  188.           method of bridging is defined in the IEEE 802.1d MAC Bridge
  189.           specification [11].  Source route bridging has been defined by
  190.           I.B.M. and is described in the Token Ring Architecture
  191.           Reference[12], as well as the IEEE 802.5M SRT Bridge
  192.           Operations Addendum [14] to 802.1d.  This memo defines objects
  193.           needed for management of a source routing bridge, and is an
  194.           extension to the SNMP Bridge MIB.
  195.  
  196.           The SNMP Bridge MIB defines objects which must be implemented
  197.           by all bridges, as well as objects needed for management of
  198.           transparent bridges.
  199.  
  200.           To be consistent with IAB directives and good engineering
  201.           practice, an explicit attempt was made to keep this MIB as
  202.           simple as possible.  This was accomplished by applying the
  203.           following criteria to objects proposed for inclusion:
  204.  
  205.           (1)  Start with a small set of essential objects and add only
  206.                as further objects are needed.
  207.  
  208.           (2)  Require objects be essential for either fault or
  209.                configuration management.
  210.  
  211.           (3)  Consider evidence of current use and/or utility.
  212.  
  213.           (4)  Limit the total of objects.
  214.  
  215.           (5)  Exclude objects which are simply derivable from others in
  216.                this or other MIBs.
  217.  
  218.           (6)  Avoid causing critical sections to be heavily
  219.                instrumented.  The guideline that was followed is one
  220.                counter per critical section per layer.
  221.  
  222.  
  223.           3.1.  Structure of MIB
  224.  
  225.           Objects in this MIB are arranged into groups.  Each group is
  226.           organized as a set of related objects.  The overall structure
  227.  
  228.  
  229.  
  230.  
  231.  
  232.           Decker/McCloghrie/Langille/Rijsinghani                [Page 4]
  233.  
  234.  
  235.  
  236.  
  237.           Internet Draft    Source Routing Bridge MIB           May 1993
  238.  
  239.  
  240.           and assignment of objects to their groups is shown below.
  241.           Where appropriate the corresponding IEEE 802.1d[11] and IEEE
  242.           802.5M [14] management object name is also included.
  243.  
  244.           SR Bridge MIB Name              IEEE 802.1d Name
  245.  
  246.             dot1dSr
  247.               PortTable
  248.                 Port
  249.                 HopCount                    SourceRoutingPort
  250.                                               .PortHopCount
  251.                 LocalSegment                  .SegmentNumber
  252.                 BridgeNum                     .BridgeNumber
  253.                 TargetSegment
  254.                 LargestFrame                  .LargestFrameSize
  255.                 STESpanMode                   .LimitedBroadcastMode
  256.                 SpecInFrames                BridgePort
  257.                                               .ValidSRFramesReceived
  258.                 SpecOutFrames                 .ValidSRForwardedOutbound
  259.                 ApeInFrames
  260.                 ApeOutFrames                  .BroadcastFramesForwarded
  261.                 SteInFrames
  262.                 SteOutFrames                  .BroadcastFramesForwarded
  263.                 SegmentMismatchDiscards       .DiscardInvalidRI
  264.                 DuplicateSegmentDiscards      .LanIdMismatch
  265.                 HopCountExceededDiscards      .FramesDiscardedHopCountExceeded
  266.  
  267.  
  268.           The following IEEE 802.1d management objects have not been
  269.           included in the SR Bridge MIB for the indicated reasons.
  270.  
  271.  
  272.           IEEE 802.1d Object              Disposition
  273.  
  274.           SourceRoutingPort
  275.                          The following objects were NOT included in
  276.                                           this MIB because they are
  277.                                           redundant or not considered
  278.                                           useful.
  279.               .LimitedBroadcastEnable
  280.               .DiscardLackOfBuffers
  281.               .DiscardErrorDetails
  282.               .DiscardTargetLANInoperable
  283.               .ValidSRDiscardedInbound
  284.               .BroadcastBytesForwarded
  285.  
  286.  
  287.  
  288.  
  289.  
  290.           Decker/McCloghrie/Langille/Rijsinghani                [Page 5]
  291.  
  292.  
  293.  
  294.  
  295.           Internet Draft    Source Routing Bridge MIB           May 1993
  296.  
  297.  
  298.               .NonBroadcastBytesForwarded
  299.               .FramesNotReceivedDueToCongestion
  300.               .FramesDiscardedDueToInternalError
  301.  
  302.           3.1.1.  The dot1dSr Group
  303.  
  304.           This group contains the objects that describe the entity's
  305.           state with respect to source route bridging.  If source
  306.           routing is not supported this group will not be implemented.
  307.           This group is applicable to source route only, and SRT
  308.           bridges.
  309.  
  310.           3.2.  Relationship to Other MIBs
  311.  
  312.           As described above, some IEEE 802.1d management objects have
  313.           not been included in this MIB because they overlap with
  314.           objects in other MIBs applicable to a bridge implementing this
  315.           MIB.  In particular, it is assumed that a bridge implementing
  316.           this MIB will also implement (at least) the Bridge MIB and the
  317.           'system' group and the 'interfaces' group defined in MIB-II
  318.           [6].
  319.  
  320.           3.2.1.  Relationship to the Bridge MIB
  321.  
  322.           The Bridge MIB must be implemented by all bridges, including
  323.           transparent, SR and SRT bridges.  The SR bridge MIB is an
  324.           extension to the Bridge MIB.
  325.  
  326.  
  327.           3.2.2.  Relationship to the 'system' group
  328.  
  329.           In MIB-II, the 'system' group is defined as being mandatory
  330.           for all systems such that each managed entity contains one
  331.           instance of each object in the 'system' group.  Thus, those
  332.           objects apply to the entity as a whole irrespective of whether
  333.           the entity's sole functionality is bridging, or whether
  334.           bridging is only a subset of the entity's functionality.
  335.  
  336.  
  337.           3.2.3.  Relationship to the 'interfaces' group
  338.  
  339.           In MIB-II, the 'interfaces' group is defined as being
  340.           mandatory for all systems and contains information on an
  341.           entity's interfaces, where each interface is thought of as
  342.           being attached to a `subnetwork'.  (Note that this term is not
  343.  
  344.  
  345.  
  346.  
  347.  
  348.           Decker/McCloghrie/Langille/Rijsinghani                [Page 6]
  349.  
  350.  
  351.  
  352.  
  353.           Internet Draft    Source Routing Bridge MIB           May 1993
  354.  
  355.  
  356.           to be confused with `subnet' which refers to an addressing
  357.           partitioning scheme used in the Internet suite of protocols.)
  358.           The term 'segment' is used in this memo to refer to such a
  359.           subnetwork.
  360.  
  361.           Implicit in this MIB is the notion of ports on a bridge.  Each
  362.           of these ports is associated with one interface of the
  363.           'interfaces' group, and in most situations, each port is
  364.           associated with a different interface. However, there are
  365.           situations in which multiple ports are associated with the
  366.           same interface.  An example of such a situation would be
  367.           several ports each corresponding one-to-one with several X.25
  368.           virtual circuits but all on the same interface.
  369.  
  370.           Each port is uniquely identified by a port number.  A port
  371.           number has no mandatory relationship to an interface number,
  372.           but in the simple case a port number will have the same value
  373.           as the corresponding interface's interface number.  Port
  374.           numbers are in the range (1..dot1dBaseNumPorts).
  375.  
  376.           Some entities perform other functionality as well as bridging
  377.           through the sending and receiving of data on their interfaces.
  378.           In such situations, only a subset of the data sent/received on
  379.           an interface is within the domain of the entity's bridging
  380.           functionality.  This subset is considered to be delineated
  381.           according to a set of protocols, with some protocols being
  382.           bridged, and other protocols not being bridged. For example,
  383.           in an entity which exclusively performed bridging, all
  384.           protocols would be considered as being bridged, whereas in an
  385.           entity which performed IP routing on IP datagrams and only
  386.           bridged other protocols, only the non-IP data would be
  387.           considered as being bridged.
  388.  
  389.           Thus, this MIB (and in particular, its counters) are
  390.           applicable only to that subset of the data on an entity's
  391.           interfaces which is sent/received for a protocol being
  392.           bridged.  All such data is sent/received via the ports of the
  393.           bridge.
  394.  
  395.  
  396.           4.  Changes from RFC 1286
  397.  
  398.           In addition to being separated from the Bridge MIB into a
  399.           separate document, the following changes were implemented as a
  400.           result of feedback from IEEE 802.5M:
  401.  
  402.  
  403.  
  404.  
  405.  
  406.           Decker/McCloghrie/Langille/Rijsinghani                [Page 7]
  407.  
  408.  
  409.  
  410.  
  411.           Internet Draft    Source Routing Bridge MIB           May 1993
  412.  
  413.  
  414.           (1)  Changed syntax of dot1dSrPortLargestFrame to INTEGER in
  415.                order to allow for having 64 possible values as described
  416.                in draft 7 of the SR Addendum.  Listed all legal values
  417.                in description.
  418.  
  419.           (2)  Updated syntax of dot1dSrPort, used to index into
  420.                dot1dSrPortTable, to use the range (1..65535).
  421.  
  422.           (3)  Added a counter to dot1dSrPortTable to count occurences
  423.                of duplicate LAN IDs or Tree errors.
  424.  
  425.           (4)  Added a counter to dot1dSrPortTable to count LAN ID
  426.                mismatches.
  427.  
  428.           (5)  Added text to dot1dSrPortSpecInFrames and
  429.                dot1dSrPortSpecOutFrames clarifying that they are also
  430.                referred to as Source Routed Frames.
  431.  
  432.           (6)  Added text to dot1dSrPortApeInFrames and
  433.                dot1dSrPortApeOutFrames clarifying that they are also
  434.                referred to as All Routes Explorer frames.
  435.  
  436.           (7)  Added a scalar variable to dot1dSr to indicate the
  437.                largest frame that may pass through the bridge.
  438.  
  439.           (8)  Added a scalar variable to dot1dSr to indicate whether
  440.                the bridge uses 3 bit or 6 bit length ngotiation fields.
  441.  
  442.           (9)  Added dot1dPortPairTableSize to indicate the size of the
  443.                following table.
  444.  
  445.           (10) Added dot1dPortPairTable to allow representation of port
  446.                pairs as defined in the IEEE 802.5M SRT Addendum.  IEEE
  447.                802.5 asserts that this table is also useful in
  448.                Transparent and SRT bridging, which the object descriptor
  449.                (the human name) reflects.
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.           Decker/McCloghrie/Langille/Rijsinghani                [Page 8]
  465.  
  466.  
  467.  
  468.  
  469.           Internet Draft    Source Routing Bridge MIB           May 1993
  470.  
  471.  
  472.           5.  Definitions
  473.  
  474.  
  475.           RFCxxxx-MIB DEFINITIONS ::= BEGIN
  476.  
  477.           IMPORTS
  478.                   Counter, Gauge
  479.                           FROM RFC1155-SMI
  480.                   dot1dSr
  481.                           FROM RFCBRIDGE-MIB -- to be replaced by DS
  482.                                              -- ver. of Bridge MIB RFC
  483.                   OBJECT-TYPE
  484.                           FROM RFC-1212;
  485.  
  486.  
  487.  
  488.           -- the dot1dSr group
  489.  
  490.           -- this group is implemented by those bridges that
  491.           -- support the source route bridging mode, including Source
  492.           -- Routing and SRT bridges.
  493.  
  494.  
  495.           dot1dSrPortTable OBJECT-TYPE
  496.               SYNTAX  SEQUENCE OF Dot1dSrPortEntry
  497.               ACCESS  not-accessible
  498.               STATUS  mandatory
  499.               DESCRIPTION
  500.                       "A table that contains information about every
  501.                       port that is associated with this source route
  502.                       bridge."
  503.               ::= { dot1dSr 1 }
  504.  
  505.           dot1dSrPortEntry OBJECT-TYPE
  506.               SYNTAX  Dot1dSrPortEntry
  507.               ACCESS  not-accessible
  508.               STATUS  mandatory
  509.               DESCRIPTION
  510.                       "A list of information for each port of a source
  511.                       route bridge."
  512.               INDEX   { dot1dSrPort }
  513.               ::= { dot1dSrPortTable 1 }
  514.  
  515.           Dot1dSrPortEntry ::=
  516.               SEQUENCE {
  517.  
  518.  
  519.  
  520.  
  521.  
  522.           Decker/McCloghrie/Langille/Rijsinghani                [Page 9]
  523.  
  524.  
  525.  
  526.  
  527.           Internet Draft    Source Routing Bridge MIB           May 1993
  528.  
  529.  
  530.                   dot1dSrPort
  531.                       INTEGER,
  532.                   dot1dSrPortHopCount
  533.                       INTEGER,
  534.                   dot1dSrPortLocalSegment
  535.                       INTEGER,
  536.                   dot1dSrPortBridgeNum
  537.                       INTEGER,
  538.                   dot1dSrPortTargetSegment
  539.                       INTEGER,
  540.                   dot1dSrPortLargestFrame
  541.                       INTEGER,
  542.                   dot1dSrPortSTESpanMode
  543.                       INTEGER,
  544.                   dot1dSrPortSpecInFrames
  545.                       Counter,
  546.                   dot1dSrPortSpecOutFrames
  547.                       Counter,
  548.                   dot1dSrPortApeInFrames
  549.                       Counter,
  550.                   dot1dSrPortApeOutFrames
  551.                       Counter,
  552.                   dot1dSrPortSteInFrames
  553.                       Counter,
  554.                   dot1dSrPortSteOutFrames
  555.                       Counter,
  556.                   dot1dSrPortSegmentMismatchDiscards
  557.                       Counter,
  558.                   dot1dSrPortDuplicateSegmentDiscards
  559.                       Counter,
  560.                   dot1dSrPortHopCountExceededDiscards
  561.                       Counter,
  562.                   dot1dSrPortDupLanIdOrTreeErrors
  563.                       Counter,
  564.                   dot1dSrPortLanIdMismatches
  565.                       Counter
  566.               }
  567.  
  568.           dot1dSrPort OBJECT-TYPE
  569.               SYNTAX  INTEGER (1..65535)
  570.               ACCESS  read-only
  571.               STATUS  mandatory
  572.               DESCRIPTION
  573.                       "The port number of the port for which this entry
  574.                       contains Source Route management information."
  575.  
  576.  
  577.  
  578.  
  579.  
  580.           Decker/McCloghrie/Langille/Rijsinghani               [Page 10]
  581.  
  582.  
  583.  
  584.  
  585.           Internet Draft    Source Routing Bridge MIB           May 1993
  586.  
  587.  
  588.               ::= { dot1dSrPortEntry 1 }
  589.  
  590.           dot1dSrPortHopCount OBJECT-TYPE
  591.               SYNTAX  INTEGER
  592.               ACCESS  read-write
  593.               STATUS  mandatory
  594.               DESCRIPTION
  595.                       "The maximum number of routing descriptors allowed
  596.                       in an All Paths or Spanning Tree Explorer frames."
  597.               ::= { dot1dSrPortEntry 2 }
  598.  
  599.           dot1dSrPortLocalSegment OBJECT-TYPE
  600.               SYNTAX  INTEGER
  601.               ACCESS  read-write
  602.               STATUS  mandatory
  603.               DESCRIPTION
  604.                       "The segment number that uniquely identifies the
  605.                       segment to which this port is connected. Current
  606.                       source routing protocols limit this value to the
  607.                       range: 0 through 4095. A value of 65535 signifies
  608.                       that no segment number is assigned to this port."
  609.               ::= { dot1dSrPortEntry 3 }
  610.  
  611.           dot1dSrPortBridgeNum OBJECT-TYPE
  612.               SYNTAX  INTEGER
  613.               ACCESS  read-write
  614.               STATUS  mandatory
  615.               DESCRIPTION
  616.                       "A bridge number uniquely identifies a bridge when
  617.                       more than one bridge is used to span the same two
  618.                       segments.  Current source routing protocols limit
  619.                       this value to the range: 0 through 15. A value of
  620.                       65535 signifies that no bridge number is assigned
  621.                       to this bridge."
  622.               ::= { dot1dSrPortEntry 4 }
  623.  
  624.           dot1dSrPortTargetSegment OBJECT-TYPE
  625.               SYNTAX  INTEGER
  626.               ACCESS  read-write
  627.               STATUS  mandatory
  628.               DESCRIPTION
  629.                       "The segment number that corresponds to the target
  630.                       segment this port is considered to be connected to
  631.                       by the bridge.  Current source routing protocols
  632.                       limit this value to the range: 0 through 4095. A
  633.  
  634.  
  635.  
  636.  
  637.  
  638.           Decker/McCloghrie/Langille/Rijsinghani               [Page 11]
  639.  
  640.  
  641.  
  642.  
  643.           Internet Draft    Source Routing Bridge MIB           May 1993
  644.  
  645.  
  646.                       value of 65535 signifies that no target segment is
  647.                       assigned to this port."
  648.               ::= { dot1dSrPortEntry 5 }
  649.  
  650.           -- It would be nice if we could use ifMtu as the size of the
  651.           -- largest frame, but we can't because ifMtu is defined to be
  652.           -- the size that the (inter-)network layer can use which can
  653.           -- differ from the MAC layer (especially if several layers of
  654.           -- encapsulation are used).
  655.  
  656.           dot1dSrPortLargestFrame OBJECT-TYPE
  657.               SYNTAX  INTEGER
  658.               ACCESS  read-write
  659.               STATUS  mandatory
  660.               DESCRIPTION
  661.                       "The maximum size of the INFO field (LLC and
  662.                       above) that this port can send/receive.  It does
  663.                       not include any MAC level (framing) octets.  The
  664.                       value of this object is used by this bridge to
  665.                       determine whether a modification of the
  666.                       LargestFrame (LF, see [14]) field of the Routing
  667.                       Control field of the Routing Information Field is
  668.                       necessary.
  669.  
  670.                       64 valid values are defined by the IEEE 802.5M SRT
  671.                       Addendum: 516, 635, 754, 873, 993, 1112, 1231,
  672.                       1350, 1470, 1542, 1615, 1688, 1761, 1833, 1906,
  673.                       1979, 2052, 2345, 2638, 2932, 3225, 3518, 3812,
  674.                       4105, 4399, 4865, 5331, 5798, 6264, 6730, 7197,
  675.                       7663, 8130, 8539, 8949, 9358, 9768, 10178, 10587,
  676.                       10997, 11407, 12199, 12992, 13785, 14578, 15370,
  677.                       16163, 16956, 17749, 20730, 23711, 26693, 29674,
  678.                       32655, 35637, 38618, 41600, 44591, 47583, 50575,
  679.                       53567, 56559, 59551, and 65535.
  680.  
  681.                       Behavior of the port when an illegal value is
  682.                       written is implementation specific.  It is
  683.                       recommended that a reasonable legal value be
  684.                       chosen."
  685.               ::= { dot1dSrPortEntry 6 }
  686.  
  687.           dot1dSrPortSTESpanMode OBJECT-TYPE
  688.               SYNTAX  INTEGER {
  689.                           auto-span(1),
  690.                           disabled(2),
  691.  
  692.  
  693.  
  694.  
  695.  
  696.           Decker/McCloghrie/Langille/Rijsinghani               [Page 12]
  697.  
  698.  
  699.  
  700.  
  701.           Internet Draft    Source Routing Bridge MIB           May 1993
  702.  
  703.  
  704.                           forced(3)
  705.                       }
  706.               ACCESS  read-write
  707.               STATUS  mandatory
  708.               DESCRIPTION
  709.                       "Determines how this port behaves when presented
  710.                       with a Spanning Tree Explorer frame.  The value
  711.                       'disabled(2)' indicates that the port will not
  712.                       accept or send Spanning Tree Explorer packets; any
  713.                       STE packets received will be silently discarded.
  714.                       The value 'forced(3)' indicates the port will
  715.                       always accept and propagate Spanning Tree Explorer
  716.                       frames.  This allows a manually configured
  717.                       Spanning Tree for this class of packet to be
  718.                       configured.  Note that unlike transparent bridging
  719.                       this is not catastrophic to the network if there
  720.                       are loops.  The value 'auto-span(1)' can only be
  721.                       returned by a bridge that both implements the
  722.                       Spanning Tree Protocol and has use of the protocol
  723.                       enabled on this port. The behavior of the port for
  724.                       Spanning Tree Explorer frames is determined by the
  725.                       state of dot1dStpPortState.  If the port is in the
  726.                       'forwarding' state, the frame will be accepted or
  727.                       propagated.  Otherwise it will be silently
  728.                       discarded."
  729.               ::= { dot1dSrPortEntry 7 }
  730.  
  731.           dot1dSrPortSpecInFrames OBJECT-TYPE
  732.               SYNTAX  Counter
  733.               ACCESS  read-only
  734.               STATUS  mandatory
  735.               DESCRIPTION
  736.                       "The number of Specifically Routed frames, also
  737.                       referred to as Source Routed Frames, that have
  738.                       been received from this port's segment."
  739.               ::= { dot1dSrPortEntry 8 }
  740.  
  741.           dot1dSrPortSpecOutFrames OBJECT-TYPE
  742.               SYNTAX  Counter
  743.               ACCESS  read-only
  744.               STATUS  mandatory
  745.               DESCRIPTION
  746.                       "The number of Specifically Routed frames, also
  747.                       referred to as Source Routed Frames, that this
  748.                       port has transmitted on its segment."
  749.  
  750.  
  751.  
  752.  
  753.  
  754.           Decker/McCloghrie/Langille/Rijsinghani               [Page 13]
  755.  
  756.  
  757.  
  758.  
  759.           Internet Draft    Source Routing Bridge MIB           May 1993
  760.  
  761.  
  762.               ::= { dot1dSrPortEntry 9 }
  763.  
  764.           dot1dSrPortApeInFrames OBJECT-TYPE
  765.               SYNTAX  Counter
  766.               ACCESS  read-only
  767.               STATUS  mandatory
  768.               DESCRIPTION
  769.                       "The number of All Paths Explorer frames, also
  770.                       referred to as All Routes Explorer frames, that
  771.                       have been received by this port from its segment."
  772.               ::= { dot1dSrPortEntry 10 }
  773.  
  774.           dot1dSrPortApeOutFrames OBJECT-TYPE
  775.               SYNTAX  Counter
  776.               ACCESS  read-only
  777.               STATUS  mandatory
  778.               DESCRIPTION
  779.                       "The number of all Paths Explorer Frames, also
  780.                       referred to as All Routes Explorer frames, that
  781.                       have been transmitted by this port on its
  782.                       segment."
  783.               ::= { dot1dSrPortEntry 11 }
  784.  
  785.           dot1dSrPortSteInFrames OBJECT-TYPE
  786.               SYNTAX  Counter
  787.               ACCESS  read-only
  788.               STATUS  mandatory
  789.               DESCRIPTION
  790.                       "The number of spanning tree explorer frames that
  791.                       have been received by this port from its segment."
  792.               ::= { dot1dSrPortEntry 12 }
  793.  
  794.           dot1dSrPortSteOutFrames OBJECT-TYPE
  795.               SYNTAX  Counter
  796.               ACCESS  read-only
  797.               STATUS  mandatory
  798.               DESCRIPTION
  799.                       "The number of spanning tree explorer frames that
  800.                       have been transmitted by this port on its
  801.                       segment."
  802.               ::= { dot1dSrPortEntry 13 }
  803.  
  804.           dot1dSrPortSegmentMismatchDiscards OBJECT-TYPE
  805.               SYNTAX  Counter
  806.               ACCESS  read-only
  807.  
  808.  
  809.  
  810.  
  811.  
  812.           Decker/McCloghrie/Langille/Rijsinghani               [Page 14]
  813.  
  814.  
  815.  
  816.  
  817.           Internet Draft    Source Routing Bridge MIB           May 1993
  818.  
  819.  
  820.               STATUS  mandatory
  821.               DESCRIPTION
  822.                       "The number of explorer frames that have been
  823.                       discarded by this port because the routing
  824.                       descriptor field contained an invalid adjacent
  825.                       segment value."
  826.               ::= { dot1dSrPortEntry 14 }
  827.  
  828.           dot1dSrPortDuplicateSegmentDiscards OBJECT-TYPE
  829.               SYNTAX  Counter
  830.               ACCESS  read-only
  831.               STATUS  mandatory
  832.               DESCRIPTION
  833.                       "The number of frames that have been discarded by
  834.                       this port because the routing descriptor field
  835.                       contained a duplicate segment identifier."
  836.               ::= { dot1dSrPortEntry 15 }
  837.  
  838.           dot1dSrPortHopCountExceededDiscards OBJECT-TYPE
  839.               SYNTAX  Counter
  840.               ACCESS  read-only
  841.               STATUS  mandatory
  842.               DESCRIPTION
  843.                       "The number of explorer frames that have been
  844.                       discarded by this port because the Routing
  845.                       Information Field has exceeded the maximum route
  846.                       descriptor length."
  847.               ::= { dot1dSrPortEntry 16 }
  848.  
  849.           dot1dSrPortDupLanIdOrTreeErrors OBJECT-TYPE
  850.               SYNTAX  Counter
  851.               ACCESS  read-only
  852.               STATUS  mandatory
  853.               DESCRIPTION
  854.                       "The number of duplicate LAN IDs or Tree errors.
  855.                       This helps in detection of problems in networks
  856.                       containing older IBM Source Routing Bridges."
  857.               ::= { dot1dSrPortEntry 17 }
  858.  
  859.           dot1dSrPortLanIdMismatches OBJECT-TYPE
  860.               SYNTAX  Counter
  861.               ACCESS  read-only
  862.               STATUS  mandatory
  863.               DESCRIPTION
  864.                       "The number of cases where a frame was forwarded,
  865.  
  866.  
  867.  
  868.  
  869.  
  870.           Decker/McCloghrie/Langille/Rijsinghani               [Page 15]
  871.  
  872.  
  873.  
  874.  
  875.           Internet Draft    Source Routing Bridge MIB           May 1993
  876.  
  877.  
  878.                       but the 'from' LAN ID was incorrect."
  879.               ::= { dot1dSrPortEntry 18 }
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.           Decker/McCloghrie/Langille/Rijsinghani               [Page 16]
  929.  
  930.  
  931.  
  932.  
  933.           Internet Draft    Source Routing Bridge MIB           May 1993
  934.  
  935.  
  936.           -- some SR bridge scalar objects
  937.  
  938.           dot1dSrBridgeLargestFrame OBJECT-TYPE
  939.               SYNTAX  INTEGER
  940.               ACCESS  read-write
  941.               STATUS  mandatory
  942.               DESCRIPTION
  943.                       "The maximum size of the INFO field (LLC and
  944.                       above) that may pass through this bridge.  The
  945.                       possible values as the same as for
  946.                       dot1dSrPortLargestFrame."
  947.               ::= { dot1dSr 2 }
  948.  
  949.           dot1dSrBridgeLfMode OBJECT-TYPE
  950.               SYNTAX  INTEGER {
  951.                           mode3(1),
  952.                           mode6(2)
  953.                       }
  954.               ACCESS  read-write
  955.               STATUS  mandatory
  956.               DESCRIPTION
  957.                       "Indicates whether the bridge operates using older
  958.                       3 bit length negotiation fields or the newer 6 bit
  959.                       length field in its RIF."
  960.               ::= { dot1dSr 3 }
  961.  
  962.           -- this object indicates the number of entries in the following
  963.           -- table.
  964.  
  965.           dot1dPortPairTableSize OBJECT-TYPE
  966.               SYNTAX  Gauge
  967.               ACCESS  read-only
  968.               STATUS  mandatory
  969.               DESCRIPTION
  970.                       "The total number of entries in the Bridge Port
  971.                       Pair Database."
  972.               ::= { dot1dSr 4 }
  973.  
  974.  
  975.           -- the Bridge Port-Pair table
  976.  
  977.           -- this table represents port pairs within a bridge forming
  978.           -- a unique bridge path, as defined in the IEEE 802.5M SRT
  979.           -- Addendum.
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.           Decker/McCloghrie/Langille/Rijsinghani               [Page 17]
  987.  
  988.  
  989.  
  990.  
  991.           Internet Draft    Source Routing Bridge MIB           May 1993
  992.  
  993.  
  994.           dot1dPortPairTable OBJECT-TYPE
  995.               SYNTAX  SEQUENCE OF Dot1dPortPairEntry
  996.               ACCESS  not-accessible
  997.               STATUS  mandatory
  998.               DESCRIPTION
  999.                       "A table that contains information about every
  1000.                       port pair database entity associated with this
  1001.                       source routing bridge."
  1002.               ::= { dot1dSr 5 }
  1003.  
  1004.           dot1dPortPairEntry OBJECT-TYPE
  1005.               SYNTAX  Dot1dPortPairEntry
  1006.               ACCESS  not-accessible
  1007.               STATUS  mandatory
  1008.               DESCRIPTION
  1009.                       "A list of information for each port pair entity
  1010.                       of a bridge."
  1011.               INDEX   { dot1dPortPairLowPort, dot1dPortPairHighPort }
  1012.               ::= { dot1dPortPairTable 1 }
  1013.  
  1014.           Dot1dPortPairEntry ::=
  1015.               SEQUENCE {
  1016.                   dot1dPortPairLowPort
  1017.                       INTEGER,
  1018.                   dot1dPortPairHighPort
  1019.                       INTEGER,
  1020.                   dot1dPortPairBridgeNum
  1021.                       INTEGER,
  1022.                   dot1dPortPairBridgeState
  1023.                       INTEGER
  1024.               }
  1025.  
  1026.           dot1dPortPairLowPort OBJECT-TYPE
  1027.               SYNTAX  INTEGER
  1028.               ACCESS  read-write
  1029.               STATUS  mandatory
  1030.               DESCRIPTION
  1031.                       "The port number of the lower numbered port for
  1032.                       which this entry contains port pair database
  1033.                       information."
  1034.               ::= { dot1dPortPairEntry 1 }
  1035.  
  1036.           dot1dPortPairHighPort OBJECT-TYPE
  1037.               SYNTAX  INTEGER
  1038.               ACCESS  read-write
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.           Decker/McCloghrie/Langille/Rijsinghani               [Page 18]
  1045.  
  1046.  
  1047.  
  1048.  
  1049.           Internet Draft    Source Routing Bridge MIB           May 1993
  1050.  
  1051.  
  1052.               STATUS  mandatory
  1053.               DESCRIPTION
  1054.                       "The port number of the higher numbered port for
  1055.                       which this entry contains port pair database
  1056.                       information."
  1057.               ::= { dot1dPortPairEntry 2 }
  1058.  
  1059.           dot1dPortPairBridgeNum OBJECT-TYPE
  1060.               SYNTAX  INTEGER
  1061.               ACCESS  read-write
  1062.               STATUS  mandatory
  1063.               DESCRIPTION
  1064.                       "A bridge number that uniquely identifies the path
  1065.                       provided by this source routing bridge between the
  1066.                       segments connected to dot1dPortPairLowPort and
  1067.                       dot1dPortPairHighPort.  The purpose of bridge
  1068.                       number is to disambiguate between multiple paths
  1069.                       connecting the same two LANs.  The default value
  1070.                       is generally either zero or one."
  1071.               ::= { dot1dPortPairEntry 3 }
  1072.  
  1073.           dot1dPortPairBridgeState OBJECT-TYPE
  1074.               SYNTAX  INTEGER {
  1075.                           enabled(1),
  1076.                           disabled(2),
  1077.                           invalid(3)
  1078.                       }
  1079.               ACCESS  read-write
  1080.               STATUS  mandatory
  1081.               DESCRIPTION
  1082.                       "The state of dot1dPortPairBridgeNum.  Writing
  1083.                       'invalid(3)' to this object removes the
  1084.                       corresponding entry."
  1085.               ::= { dot1dPortPairEntry 4 }
  1086.  
  1087.  
  1088.  
  1089.  
  1090.           END
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.           Decker/McCloghrie/Langille/Rijsinghani               [Page 19]
  1103.  
  1104.  
  1105.  
  1106.  
  1107.           Internet Draft    Source Routing Bridge MIB           May 1993
  1108.  
  1109.  
  1110.           6.  Acknowledgments
  1111.  
  1112.           This document was produced on behalf of the Bridge Sub-Working
  1113.           Group of the SNMP Working Group of the Internet Engineering
  1114.           Task Force.
  1115.  
  1116.           The authors wish to thank the members of the Bridge Working
  1117.           Group for their many comments and suggestions which improved
  1118.           this effort. In particular, Fred Baker (chairman of the
  1119.           working group) of ACC, Steve Sherry of Xyplex, Frank
  1120.           Kastenholz of Clearpoint Research Corp, and Richard Sweatt of
  1121.           Synoptics who was also IEEE 802.5's designated liaison to this
  1122.           WG in drafting this SR MIB.  Others members of the Bridge
  1123.           Working Group who contributed to this effort are:
  1124.  
  1125.                Bill Anderson, Mitre
  1126.                Karl Auerbach, Epilogue
  1127.                Fred Baker, ACC (chair)
  1128.                Terry Bradley, Wellfleet
  1129.                Ted Brunner, Bellcore
  1130.                Jeffrey Buffum, Apollo
  1131.                Chris ChioTasso, Fibronics
  1132.                Anthony Chung, HLS
  1133.                Chuck Davin, MIT-LCS
  1134.                Andy Davis, Spider
  1135.                Eric Decker, cisco
  1136.                Nadya El-Afandi, Network Systems
  1137.                Gary Ellis,HP/Apollo
  1138.                Richard Fox, SynOptics
  1139.                Stan Froyd, ACC
  1140.                Frank Kastenholz, Clearpoint Research
  1141.                Shirnshon Kaufman,
  1142.                Jim Kinder, Fibercom
  1143.                Cheryl Krupczak,NCR
  1144.                Paul Langille, Digital
  1145.                Peter Lin,Vitalink
  1146.                Keith McCloghrie, HLS
  1147.                Donna McMaster, SynOptics
  1148.                Dave Perkins, 3Com
  1149.                Jim Reinstedler, Ungermann Bass
  1150.                Anil Rijsinghani, Digital
  1151.                Mark Schaefer, David Systems
  1152.                Steve Sherry, Xyplex
  1153.                Bob Stewart, Xyplex
  1154.                Emil Sturniolo,
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.           Decker/McCloghrie/Langille/Rijsinghani               [Page 20]
  1161.  
  1162.  
  1163.  
  1164.  
  1165.           Internet Draft    Source Routing Bridge MIB           May 1993
  1166.  
  1167.  
  1168.                Richard Sweatt, SynOptics
  1169.                Kevin Synott, Retix
  1170.                Ian Thomas, Chipcom
  1171.                Maurice Turcott, Racal
  1172.                Fei Xu
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.           Decker/McCloghrie/Langille/Rijsinghani               [Page 21]
  1219.  
  1220.  
  1221.  
  1222.  
  1223.           Internet Draft    Source Routing Bridge MIB           May 1993
  1224.  
  1225.  
  1226.           7.  References
  1227.  
  1228.           [1]  V. Cerf, IAB Recommendations for the Development of
  1229.                Internet Network Management Standards.  Internet Working
  1230.                Group Request for Comments 1052.  Network Information
  1231.                Center, SRI International, Menlo Park, California,
  1232.                (April, 1988).
  1233.  
  1234.           [2]  V. Cerf, Report of the Second Ad Hoc Network Management
  1235.                Review Group, Internet Working Group Request for Comments
  1236.                1109.  Network Information Center, SRI International,
  1237.                Menlo Park, California, (August, 1989).
  1238.  
  1239.           [3]  M.T. Rose and K. McCloghrie, Structure and Identification
  1240.                of Management Information for TCP/IP-based internets,
  1241.                Internet Working Group Request for Comments 1155.
  1242.                Network Information Center, SRI International, Menlo
  1243.                Park, California, (May, 1990).
  1244.  
  1245.           [4]  K. McCloghrie and M.T. Rose, Management Information Base
  1246.                for Network Management of TCP/IP-based internets,
  1247.                Internet Working Group Request for Comments 1156.
  1248.                Network Information Center, SRI International, Menlo
  1249.                Park, California, (May, 1990).
  1250.  
  1251.           [5]  J.D. Case, M.S. Fedor, M.L. Schoffstall, and J.R. Davin,
  1252.                Simple Network Management Protocol, Internet Working
  1253.                Group Request for Comments 1157.  Network Information
  1254.                Center, SRI International, Menlo Park, California, (May,
  1255.                1990).
  1256.  
  1257.           [6]  K. McCloghrie and M.T. Rose (editors), Management
  1258.                Information Base for Network Management of TCP/IP-based
  1259.                internets: MIB-II, Internet Working Group Request for
  1260.                Comments 1213.  Network Information Center, SRI
  1261.                International, Menlo Park, California, (March, 1991).
  1262.  
  1263.           [7]  Information processing systems - Open Systems
  1264.                Interconnection - Specification of Abstract Syntax
  1265.                Notation One (ASN.1), International Organization for
  1266.                Standardization.  International Standard 8824, (December,
  1267.                1987).
  1268.  
  1269.           [8]  Information processing systems - Open Systems
  1270.                Interconnection - Specification of Basic Encoding Rules
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.           Decker/McCloghrie/Langille/Rijsinghani               [Page 22]
  1277.  
  1278.  
  1279.  
  1280.  
  1281.           Internet Draft    Source Routing Bridge MIB           May 1993
  1282.  
  1283.  
  1284.                for Abstract Notation One (ASN.1), International
  1285.                Organization for Standardization.  International Standard
  1286.                8825, (December, 1987).
  1287.  
  1288.           [9]  M.T. Rose, K. McCloghrie (editors), Concise MIB
  1289.                Definitions, Internet Working Group Request for Comments
  1290.                1212.  Network Information Center, SRI International,
  1291.                Menlo Park, California, (March, 1991).
  1292.  
  1293.           [10] M.T. Rose (editor), A Convention for Defining Traps for
  1294.                use with the SNMP, Internet Working Group Request for
  1295.                Comments 1215.  Network Information Center, SRI
  1296.                International, Menlo Park, California, (March, 1991).
  1297.  
  1298.           [11] ANSI/IEEE Standard 802.1D-1990 MAC Bridges, IEEE Project
  1299.                802 Local and Metropolitan Area Networks, (March 8,
  1300.                1991).
  1301.  
  1302.           [12] I.B.M. Token Ring Architecture Reference
  1303.  
  1304.           [13] ISO DIS 10038 MAC Bridges
  1305.  
  1306.           [14] ANSI/IEEE P802.5M-D7, Source Routing Transparent Bridge
  1307.                Operation, IEEE Project 802.
  1308.  
  1309.           [15] ANSI/IEEE 802.1y, Source Routing Tutorial for End System
  1310.                Operation, (September, 1990)
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.           Decker/McCloghrie/Langille/Rijsinghani               [Page 23]
  1335.  
  1336.  
  1337.  
  1338.  
  1339.           Internet Draft    Source Routing Bridge MIB           May 1993
  1340.  
  1341.  
  1342.           Table of Contents
  1343.  
  1344.  
  1345.           1 Introduction ..........................................    2
  1346.           2 The Network Management Framework ......................    3
  1347.           2.1 Object Definitions ..................................    3
  1348.           3 Overview ..............................................    4
  1349.           3.1 Structure of MIB ....................................    4
  1350.           3.1.1 The dot1dSr Group .................................    6
  1351.           3.2 Relationship to Other MIBs ..........................    6
  1352.           3.2.1 Relationship to the Bridge MIB ....................    6
  1353.           3.2.2 Relationship to the 'system' group ................    6
  1354.           3.2.3 Relationship to the 'interfaces' group ............    6
  1355.           4 Changes from RFC 1286 .................................    7
  1356.           5 Definitions ...........................................    9
  1357.           7.1 The dot1dSr Group Definitions .......................    9
  1358.           6 Acknowledgments .......................................   20
  1359.           7 References ............................................   22
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.           Decker/McCloghrie/Langille/Rijsinghani               [Page 24]
  1393.